home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / zcommdoc.zip / ZCOMMDOC.AF < prev    next >
Text File  |  1993-05-30  |  71KB  |  1,771 lines
  1.  
  2.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                  151
  4.  
  5.       szb [-options] [PREFIX=p | ONAME=x] pathspec As above, but "falls
  6.         back" to YMODEM if the receiver cannot receive files with ZMODEM
  7.         protocol.  Because of the YMODEM fallback, szb is not as error
  8.         resistant as the sz command.
  9.  
  10.       t [-term_options] [capturefile] Invokes the term function for
  11.         conversational access to the remote.  Normally, ZCOMM will remain in
  12.         the termfunction until the user keyboards F1.
  13.  
  14.         If capturefile is specified, any currently opten capture file is
  15.         closed and capturefile is opened.  A file previously opened by "t
  16.         file" is not closed by a t command given without an argument.
  17.  
  18.         EXAMPLE: t file1 Creates file1 to capture data sent by the remote in
  19.         interactive conversation.
  20.  
  21.  
  22.         SEE ALSO: create command
  23.  
  24.         If a file upload begun by an f or open command were in progress, the
  25.         upload will resume with the t command subject to the g term option.
  26.  
  27.         In host operation, "t file" begins data capture, and received
  28.         characters are not echoed.  When the remote sends ETX, EOT, or
  29.         Ctrl-Z, file is closed and the term function exits.
  30.  
  31.         EXAMPLE: t comments.txt<ENTER>
  32.         jabber ... jabber ... Ctrl-Z
  33.  
  34.  
  35.         Optional termoptions may be enabled to modify the display, storage,
  36.         or transmission of information.
  37.  
  38.         Subcommands available from the term function are explained in
  39.         Chapter 21.  Characters special to the term function are also
  40.         described in Chapter 21.
  41.  
  42.       tcs M N The local display of ASCII characters can be remapped to suit
  43.         local requirements with the tcs (Terminal Character Set) command,
  44.         where M is the incoming character (1 to 255) and N is the desired
  45.         hardware character 1 to 255.
  46.  
  47.         EXAMPLE: tcs 91 146 translates the ASCII [ character to the AE
  48.         character.
  49.  
  50.  
  51.         The command tcs by itself disables these translations but does not
  52.         reset the translation table.
  53.  
  54.         The command tcs 0 resets the entries in the translation table.
  55.  
  56.  
  57.  
  58.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  59.  
  60.  
  61.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                  152
  63.  
  64.         SEE ALSO: display command
  65.  
  66.       timestamp * Iff a capture file is open, write out the circular buffer.
  67.         Then write a line containing the remote system name, number of
  68.         characters transmitted from disk, the number of characters received
  69.         to disk, average characters received per second, [20] the date and
  70.         time, and the term function status line information (time, options,
  71.         etc.) to the file and to the display.
  72.  
  73.         EXAMPLE: timestamp; echoc "End: %e Errors"
  74.            Timestamp: vif 0 127857 97/sec 1342:37 07-09-86
  75.            01 24 13:42 21:50   28672 2:1200 7e  EhjSt >cis0709.tmp
  76.            Allsig Ends: 0 Errors
  77.  
  78.         The character counts are reset when the corresponding files are
  79.         opened.
  80.  
  81.         SEE ALSO: restime, ALT-E commands, E test condition, t string
  82.         parameter
  83.  
  84.       trs svar string1 string2 String1 and string2 are first processed for
  85.         character escapes.  Then translate string variable svar from the
  86.         character set in string1 into the character set in string2.  *
  87.         Characters in String1 with no corresponding character in String2 are
  88.         deleted.  Characters in svar not appearing in String1 are not
  89.         modified.  The "trs" command may not be used in the body of a
  90.         "while" command.
  91.  
  92.         EXAMPLE: trs s0 "\\{}" "/" Changes backslashes to slashes, and
  93.         removes "{" and "}" characters.
  94.  
  95.  
  96.       TYPe pathspec Type the specified file(s).  This command closes any
  97.         open transmit file.  Type pauses/resumes printing with ^S.
  98.         Keyboarding ^C or Ctrl-Break cancels, and ^X skips to the next file.
  99.         <Ctrl-Home> clears the screen without pausing, avoiding scrolling.
  100.  
  101.         SEE ALSO: browse, list, page commands, Unix b, bro, typ commands
  102.  
  103.         EXAMPLE: type *.txt *.doc
  104.  
  105.  
  106.       unrestrict Prompts for a password and unrestricts ZCOMM if the
  107.         password exactly matches the contents of the unrestrict string
  108.         parameter.  If unrestrict is empty or the given password does not
  109.  
  110.  
  111.       __________
  112.  
  113.       20. Since the last call or restime command.
  114.  
  115.  
  116.  
  117.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  118.  
  119.  
  120.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                  153
  122.  
  123.         match in three attempts, the call is immediately terminated.
  124.         Unrestrict is used in Host Operation by a caller who wishes
  125.         unrestricted access to ZCOMM's computer to view confidential files
  126.         or perform maintenance.
  127.  
  128.         EXAMPLE: unrestrict Prompts for a password (to match the unrestrict
  129.         parameter), then allows three tries to enter it correctly.
  130.  
  131.  
  132.         SEE ALSO: Host operation
  133.  
  134.       videobios N Sets the video BIOS mode to N.  This command is useful for
  135.         accessing the high resolution super EGA display text modes, such as
  136.         100 columns by 75 lines corresponding to high resolution 800x600
  137.         displays.  The $ and # numeric parameters must be separately set to
  138.         agree with the new BIOS video mode.
  139.  
  140.         The action of the video ROM BIOS to specific values depends on the
  141.         particular EGA/VGA ROM BIOS used.  To support boards using an
  142.         extended code in the bl register, calculate N = bl + (256 * al).
  143.  
  144.         Some codes produce spectacular unpredictable results.  This command
  145.         is restricted, and is available on medium model DOS flavors only.
  146.  
  147.         EXAMPLE: videobios 3 Sets BIOS video mode 3 (80x25).
  148.  
  149.  
  150.         SEE ALSO: V and W numeric parameters
  151.  
  152.       w Writes the contents of the circular buffer to the capture file.
  153.  
  154.       wait [-term_options] Wait activates the term function to search for
  155.         each pattern that has been defined with the pattern command.  If a
  156.         file has been opened with the create or t file commands, buffer
  157.         capture continues during the wait command.  If a file upload
  158.         (inititated by an f file command) was in progress, the upload will
  159.         resume with the wait command subject to the g term option.
  160.  
  161.         Script execution resumes when the wait command returns because of a
  162.         pattern match, timeout, no carrier detect, or keyboarded F1.  The
  163.         wait command's pattern search timeout is effective even if no search
  164.         patterns have been set with the pattern command.
  165.  
  166.         SEE ALSO: pattern, put, putw commands, fN term option
  167.  
  168.       wc pathspec Counts lines, words, printing characters, and all
  169.         characters for the specified files.  The totals are then presented.
  170.         Characters beginning with CPMEOF (^Z) are excluded.[21] The count of
  171.  
  172.  
  173.  
  174.  
  175.  
  176.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  177.  
  178.  
  179.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                  154
  181.  
  182.         printing characters is useful for estimating laser toner and printer
  183.         ribbon usage.
  184.  
  185.         EXAMPLE: wc *.c *.h
  186.  
  187.  
  188.         SEE ALSO: crc, sum commands
  189.  
  190.       while condition rest-of-line Scripts must often repeat a command or
  191.         set of commands while some condition remains true.  The while
  192.         command executes the command(s) on the rest of the line while
  193.         condition is true.  Chapter 27 describes testable conditions.  An
  194.         inadvertently generated while loop may be stopped by keyboarding
  195.         NUKE (ALT-N).
  196.         N.B.: The rest of the line must not contain an if command or
  197.         semicolons separating commands.  While commands may not be nested.
  198.  
  199.         EXAMPLE: pat 1 "ogin:";  while !1 put "\r" wait -f1 Repeatedly sends
  200.         a carriage return until the remote responds with "Login:".[22]
  201.  
  202.  
  203.         EXAMPLE: while "!1&&L<5" put "\r" wait -f1 Works as above, but only
  204.         tries 5 times.
  205.  
  206.  
  207.       x (eXit) Writes and closes any open files, releases ownership of the
  208.         serial port, then exits to the operating system without
  209.         disconnecting the phone line.[23] Exit status is the value of the ?
  210.         numeric parameter.  This command is not allowed if Restricted.
  211.  
  212.       xpc ... * The ZCOMMXPC flavor of ZCOMM supports the Tymnet(TM) X.PC
  213.         link level protocol with the xpc commands.  See a following
  214.         subchapter of Chapter 19 for a more detailed description of the X.PC
  215.         packet driver and the xpc commands that control it.
  216.  
  217.  
  218.  
  219.  
  220.       ______________________________________________________________________
  221.  
  222.       21. The line and word counts agree with the Unix word count program,
  223.           but the character count will differ because of CR characters not
  224.           stored in most Unix text files.  The Unix word count program does
  225.           not have a count of printing characters.
  226.  
  227.       22. The "L" in "Login" is not searched for on purpose.  On Unix
  228.           systems, the "l" is not always capitalized.
  229.  
  230.       23. On some Unix systems, the operating system may alter the state of
  231.           the serial port after ZCOMM exits.
  232.  
  233.  
  234.  
  235.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  236.  
  237.  
  238.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                  155
  240.  
  241.       xy [column] row Place the cursor on the local display specified column
  242.         and row.  The home position corresponds to an xy 1 1 command.
  243.         Column and row can be string parameters holding numbers.
  244.  
  245.       zcommandi COMMAND Send COMMAND with ZMODEM protocol, do NOT wait for
  246.         command completion.
  247.  
  248.         EXAMPLE: zcommandi "!make whoopie"
  249.  
  250.  
  251.       zcommandic COMMAND Process COMMAND for string substitutions and
  252.         character escapes and send with ZMODEM protocol, do NOT wait for
  253.         command completion.
  254.  
  255.       zcommandw COMMAND Send COMMAND to the remote with ZMODEM protocol.
  256.         ZMODEM assures an error free command upload.  Wait for COMMAND to
  257.         complete on the remote.  Store the command's exit value in the ?
  258.         numeric parameter, available to the ?  test condition.
  259.         N.B.: With the exception of sz, no command that involves the serial
  260.         port may be the argument of zcommand.
  261.  
  262.         EXAMPLE: zcommandw "sz foo.bar" Causes the remote to send a file
  263.         with ZMODEM protocol.
  264.  
  265.  
  266.         EXAMPLE: zcommandw "!ls -l | sz -a -" Causes a remote Unix system to
  267.         send a file containing a directory listing to ZCOMM.
  268.  
  269.  
  270.         As a special case, zcommandw with an empty command fetches the
  271.         remote's disk file system free character count.  This quantity is
  272.         then available to the R test condition.
  273.  
  274.         EXAMPLE: zcommandw ""; if "R>10000" sz hugefile Fetches the free
  275.         disk space from the remote, and sends hugefile if the destination's
  276.         free space is greater than 10000 kilobytes.
  277.  
  278.  
  279.       zcommandwc COMMAND Process COMMAND for string substitutions and
  280.         character escapes and send with ZMODEM protocol, wait for command
  281.         completion.
  282.  
  283.       zmodem Used as a prefix to the p command to select the "zmodem"
  284.         parameters, or by itself to select the ZMODEM protocol for commands
  285.         which operate in a choice of protocols depending on past history.
  286.  
  287.         EXAMPLE: zmodem
  288.              !!sz *.*
  289.         Uses ZMODEM to send a command to the remote machine to send all the
  290.         files in its current directory.
  291.  
  292.  
  293.  
  294.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  295.  
  296.  
  297.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                  156
  299.  
  300.       _ Enter a diagnostic routine that prints information about each
  301.         keystroke entered.  Keyboarding LF (Ctrl-Enter) exits the _
  302.         (underscore) command.  When a key is struck, the scancode, modified
  303.         scancode, and the shift state are displayed in decimal.  The
  304.         modified scancode is either the raw scancode as returned by the BIOS
  305.         or 224 added to the ZCOMM internal code iff the raw scancode equals
  306.         224.  The ZCOMM internal code for the key (usually the ASCII value)
  307.         is displayed in octal.  This command may be used for exploring
  308.         keyboard encoding and preparing alternate keyboard mappings for use
  309.         with the mk command.
  310.  
  311.         SEE ALSO: mk command
  312.  
  313.  
  314.       ![%][~]command Invoke the local operating system to execute command
  315.         (either a program or a DOS built-in command) as a subprogram.  A
  316.         leading % (percent sign) processes Command for string parameter
  317.         substitutions.  See Chapter 19.5 for details on DOS Gateways and
  318.         Unix Shell Escapes.
  319.  
  320.  
  321.       !!host-command Sends the rest of the line (after !!) to a remote
  322.         ZMODEM program or Kermit server for execution on the server machine.
  323.         host-command is not processed for string parameters.  This is a
  324.         convenient alternative to remote host host-command-string
  325.         particularly if host-command contains spaces.
  326.  
  327.       label: A label begins at the first column and ends with a colon.  One
  328.         or more commands may appear on the same line separated from the
  329.         label by white space.  A label may have the same name as a directory
  330.         entry provided the directory entry appears first in the script file.
  331.         N.B.: a label differs from a directory entry, which doesn't end with
  332.         a colon.  When ZCOMM encounters the next directory entry in script
  333.         processing, an automatic "return" is performed.
  334.  
  335.         EXAMPLE: if 1 goto cond1
  336.              echo "Pattern 1 not matched"
  337.         cond1:    echo "processing continues"
  338.         foosys    speed 2400 666-1234 t
  339.  
  340.  
  341.       :comment A colon as first character in a command causes the rest of
  342.         the command line to be ignored.  This is also useful for "commenting
  343.         out" commands in script files.
  344.  
  345.         EXAMPLE: : this line does nothing at all
  346.  
  347.  
  348.       ; Semicolon is a command delimiter which may be used in place of
  349.         RETURN to place multiple commands on a line.  Since commands such as
  350.         echo, set, sb, pattern, list, and type take an indefinite number of
  351.  
  352.  
  353.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  354.  
  355.  
  356.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                  157
  358.  
  359.         operands, the semicolon must be used to string such commands
  360.         together.
  361.  
  362.         EXAMPLE: sb *.c; off Batch transmits all *.c files, then puts the
  363.         modem on hook and exits to DOS.
  364.  
  365.         Semicolon is not a command delimiter if it is escaped by a backslash
  366.         or if it appears within a quoted string.
  367.  
  368.         EXAMPLE: pat 0 ";" Sets pattern 0 to search for a semicolon.
  369.  
  370.         Commands that take a fixed number of arguments may be strung
  371.         together without a semicolon unless otherwise noted.
  372.  
  373.         EXAMPLE: port 1 speed 1200
  374.  
  375.  
  376.       <file Redirects input used by the command prompt and review function.
  377.         When reading input from file, certain characters are special:
  378.  
  379.             ~  Accept the next character verbatim.
  380.  
  381.             |  Sleep for one second.
  382.  
  383.             '' Double quote echoes succeeding characters to the display with
  384.                highlighting until the next double quote is encountered.
  385.       On end of file, a ^U is returned and input reverts to the keyboard.
  386.       The file rev on the demonstration disk is a typical file which might
  387.       be used with the < command.
  388.  
  389.       >[>]outfile Redirects output from succeeding utility commands and
  390.         debug output (if the v numeric parameter is non zero) to outfile.
  391.         Capture from the circular buffer is also enabled, but there is no
  392.         automatic writing of the circular buffer to the file on close.
  393.         >>outfile appends to outfile.  The output redirection is canceled by
  394.         the close command or by > without a filename.  DOS predefined device
  395.         names such as "prn" may be used.
  396.  
  397.         The syntax of ZCOMM's redirection differs from that used by DOS and
  398.         UNIX. ZCOMM's output must be redirected before the command(s) are
  399.         given, and the redirection stays in effect until explicitly
  400.         canceled.  ZCOMM's command prompt is not redirected.
  401.  
  402.         EXAMPLE: bdump file0
  403.              kill
  404.              >file1
  405.              dump file0
  406.              close
  407.         Dumps the contents of the modem input buffer to file0.  Output is
  408.         then redirected to file1 and contents of file0 are displayed in side
  409.         by side hex/ascii format.
  410.  
  411.  
  412.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  413.  
  414.  
  415.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                  158
  417.  
  418.         Note that the create and t filename commands do not redirect utility
  419.         command output to the file.
  420.  
  421.  
  422.       19.1  Function Key Commands
  423.  
  424.       Some function keys are recognized at the command prompt.  Function key
  425.       commands may not be mixed with any other character.  For example,
  426.       keyboarding "t PgUp" elicits an error bell.
  427.  
  428.       Some scrips redefine the function keys.  The standard assignments may
  429.       be restored with a gosub setup command.
  430.  
  431.  
  432.       F2 From the command prompt, F2 enters term function.
  433.  
  434.         SEE ALSO: t [file] command
  435.  
  436.       Up Select the previous command in the command stack for reentry.
  437.  
  438.       Down Select the next command in the command stack for reentry.
  439.  
  440.       Home,PgUp,End Enter the review function.
  441.  
  442.       F3...F10 Function keys F3 to F10 are programmed by set commands in the
  443.         "setup" directory in the distributed telephone directory.  The key
  444.         definitions in PHODIR.t may be modified or removed at your
  445.         discretion.
  446.  
  447.       F3 Receives files with YMODEM protocol, or XMODEM. [24]
  448.  
  449.       F4 Invokes TurboLearn Script Writer(TM) to record keystrokes and
  450.         computer dialog, then generates a script using this information.
  451.  
  452.         If ZCOMM is not currently connected to a system, the script called
  453.         by F4 prompts the user for telephone number, baud rate, and parity.
  454.         When recording is finished, the script prompts for a pathname to
  455.         store the completed TruboDial script in.
  456.  
  457.       F5 On Unix systems, begin background operation and issue a sub shell
  458.         for the user.  ZCOMM operation proceeds with screen output
  459.         suppressed.  If ZCOMM should require keyboard input before the user
  460.         returns, ZCOMM waits for the user to return.
  461.  
  462.  
  463.  
  464.       __________
  465.  
  466.       24. ZCOMM generates a file name if the sending program does not
  467.           provide one.
  468.  
  469.  
  470.  
  471.       (C) 1993 Omen Tech Inc                Chapter 19 Function Key Commands
  472.  
  473.  
  474.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                  159
  476.  
  477.       F6 Prompts for a file name, then receives that file with the XMODEM-
  478.         CRC protocol.  ZCOMM will revert to the basic XMODEM protocol after
  479.         a few timeouts if the sender does not support CRC-16.
  480.  
  481.       F7 Prompts for a file name, then transmits that file with XMODEM
  482.         protocol.  If the file name includes wildcard characters, or if more
  483.         than one file name is given, or if a directory name is given, YMODEM
  484.         protocol will be used.
  485.  
  486.       F8 Generates and transmits a password based on the called system's
  487.         name and the string parameter xpassword.  * This command is valid
  488.         only when called from the term function.
  489.  
  490.       F9 Calls a script to add a new system entry to the Telephone
  491.         Directory.  The script prompts for a system name, and checks for
  492.         duplications with entries currently in the Phone Directory.  The
  493.         script prompts for comments which will display when that system is
  494.         called.  Speed and parity are then prompted for, and the entry is
  495.         added to the end of the Phone Directory.
  496.  
  497.       F10 Invokes the "help" command or help processor.
  498.  
  499.       Shift-F1 List the Phone directory.
  500.  
  501.       Shift-F2 Search Phone Directory for system names matching user
  502.         supplied string.
  503.  
  504.       Shift-F3 List voice calls in the Phone Directory.
  505.  
  506.       Shift-F4 Disconnect the modem from telephone line (hang it up).
  507.  
  508.       Shift-F5 Prompt for a system name and add a command to call it to the
  509.         circular dialing queue.  List the queue contents.
  510.  
  511.       Shift-F6 Run (execute) the circular dialing queue.
  512.        The following function keys are valid at the main command prompt,
  513.       from the term function, and from the review function.
  514.  
  515.       Ctrl-Home Resets display modes and clears the screen.
  516.  
  517.       ALT-1 Prompt for a command to be executed by the operating system,
  518.         then execute it.
  519.  
  520.         EXAMPLE: ALT-1
  521.         DOS Command: dir/w
  522.  
  523.  
  524.       ALT-2 Prompt for a ZCOMM command, then execute it.
  525.  
  526.         EXAMPLE: ALT-2
  527.         YAM Command: speed 115200
  528.  
  529.  
  530.       (C) 1993 Omen Tech Inc                Chapter 19 Function Key Commands
  531.  
  532.  
  533.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                  160
  535.  
  536.       ALT-C Writes the circular buffer to disk and closes any open send or
  537.         receive file(s).  ZCOMM complains if no files were open.
  538.  
  539.         SEE ALSO: close command
  540.  
  541.       ALT-D Lists the current directory of the default disk.
  542.  
  543.         SEE ALSO: dirr command
  544.  
  545.       ALT-M Toggles keyboard mapping.
  546.  
  547.         SEE ALSO: display mapkb command, N numeric parameter
  548.  
  549.       ALT-R Enter the review function.
  550.  
  551.         SEE ALSO: review command
  552.  
  553.       ALT-S Displays status on the local screen only, even if ZCOMM is in
  554.         host operation.
  555.  
  556.         SEE ALSO: s command
  557.  
  558.       ALT-U Toggles Upper case conversion of keyboard and file characters
  559.         sent with the term function ( t, f, F2 commands).  The answerback
  560.         and programmed strings are not affected.  Protocol file transfers
  561.         are not affected.  The u term option is reset by the call command.
  562.  
  563.         SEE ALSO: u mode
  564.  
  565.       ALT-W Writes the circular buffer to the receive file.  Equivalent to
  566.         the main w command.
  567.  
  568.         SEE ALSO: w command
  569.  
  570.       F1...FA10 etc. The Soft Keys can be programmed (with "set" commands)
  571.         either to send a string of characters to the remote or to invoke a
  572.         ZCOMM command sequence.  Iff the string begins with "@", the
  573.         remainder of the string is treated as a ZCOMM command.  No strings
  574.         are sent to the remote from the command prompt or from the review
  575.         function.
  576.  
  577.         The soft keys can be changed for each remote system or different
  578.         application programs, with set commands embedded in the appropriate
  579.         telephone directory entry.  The ALT-K key displays the strings
  580.         assigned to these keys.
  581.  
  582.         There are 48 soft keys, f1 to f12,fs1 to fs12,fc1 to fc12,fa1 to
  583.         fa12, plus some of the cursor keys.  ( fs1 is obtained by Shift-F1.
  584.         fc1 is obtained by Ctrl-F1.  fa1 is obtained by Alt-F1.) In
  585.         addition, the cursor keys may be reassigned to send strings to the
  586.         remote when in the term function.  To list them, set the v (verbose)
  587.  
  588.  
  589.       (C) 1993 Omen Tech Inc                Chapter 19 Function Key Commands
  590.  
  591.  
  592.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                  161
  594.  
  595.         parameter non zero ("pv1"), then give a "set" command.  Most soft
  596.         keys have names beginning with f, and are described in Chapter 25.
  597.  
  598.       19.2  Browse Command
  599.  
  600.       BROwse pathspec browses through the specified files.  If pathspec is
  601.       empty, all files are presented.  For each matched pathname, the
  602.       filename, date, and length are displayed.  The status line displays
  603.       some of the possible (one letter) commands.
  604.  
  605.       EXAMPLE: >>>c:bro *.c
  606.       CFLOW.C          13:18:10 02-25-86   6072 ?
  607.       app, back, copy, Del, mv, next, page, sz, S, quit, {rR}ead, view, !, @
  608.  
  609.  
  610.  
  611.       a, A Prompts for a pathname and then appends the current file to it.
  612.         Both DOS and CP/M format files are handled correctly.  The A choice
  613.         then deletes the file.
  614.  
  615.       b Backs up to the previous file.  Browse will not back up past a
  616.         deleted or renamed file.
  617.  
  618.       c prompts for a target pathname.  The resulting DOS command
  619.         copy file target is executed by a copy of COMMAND.COM.  Target may
  620.         include the switches available with the DOS copy command.  The
  621.         pathnames given must be legal for DOS, with \ separating directories
  622.         from filenames.[25]
  623.  
  624.         EXAMPLE: c
  625.         Copy to: a:
  626.  
  627.  
  628.         SEE ALSO: "HINT" below
  629.  
  630.       D Deletes the file.
  631.  
  632.       SP, CR skip to the next file.
  633.  
  634.       r, R The R subcommand first kills the circular buffer.  Then read the
  635.         file (or as much as will fit) into the circular buffer, then call
  636.         the review function.  The review function subcommands can be used to
  637.         page back and forth through the file, write portions of the buffer
  638.         to files, and so on.  If review is exited with the file still open,
  639.         browse closes it.  This subcommand is not available if Restricted.
  640.  
  641.  
  642.       __________
  643.  
  644.       25. Unless the DOS SWITCHAR has been changed to "/".
  645.  
  646.  
  647.  
  648.       (C) 1993 Omen Tech Inc                       Chapter 19 Browse Command
  649.  
  650.  
  651.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                  162
  653.  
  654.         SEE ALSO: review function
  655.  
  656.       n Sends the file with the ZMODEM n option (send file only if the
  657.         source is newer than the destination).
  658.  
  659.       S sends the selected file with XMODEM protocol.  The user must start
  660.         an XMODEM receive on the other machine.
  661.  
  662.       s sends the selected file with ZMODEM or YMODEM Protocol and 1kb
  663.         packets.  If the other program has ZMODEM AutoDownload enabled (Z
  664.         mode) the file transmission will be automatic.  Otherwise, the user
  665.         must start a YMODEM or ZMODEM receive on the other machine.  The s
  666.         and S subcommands are useful when issued by a remote caller browsing
  667.         through files in a directory.
  668.  
  669.       t Tail reads the tail of the file into the circular buffer and
  670.         displays the last 24 lines.
  671.  
  672.       Q, X Quit ends the file list.  X is provided for the convenience of
  673.         users accustomed to the wash and sweep programs.
  674.  
  675.       V, Ctrl-V View the file, whether it is a regular or SQueezed file.
  676.  
  677.       ! prompts for a DOS command and then attempts to execute it.  Some DOS
  678.         commands that might be useful are rename, del, print, move, emacs,
  679.         mince, edlin, chkdsk, and chmod.  When entering the DOS command, a
  680.         keyboarded % is replaced by the pathname of the currently selected
  681.         file.
  682.  
  683.         Please refer to the !  command for details and caveats.
  684.  
  685.         EXAMPLE: !emacs % calls EMACS to edit the selected file.
  686.  
  687.  
  688.       @ Prompts for a ZCOMM command, and then executes that command as if it
  689.         had been entered at the main command prompt.  The @ subcommand
  690.         should not be used for any command that involves file names.
  691.  
  692.         EXAMPLE: @display vt100
  693.  
  694.  
  695.       * Any other letter redisplays the file information and repeats the
  696.         prompt.
  697.  
  698.       After the file list is exhausted, ZCOMM prints the free storage
  699.       remaining on the default disk.
  700.       HINT: Use a directory command to change the order in which the files
  701.       are presented for the browse command.  For example, assume we have a
  702.       directory src on drive c: (hard disk) and a floppy drive F: with a
  703.       scratch disk inserted.  The command sequence
  704.           dirt
  705.  
  706.  
  707.       (C) 1993 Omen Tech Inc                       Chapter 19 Browse Command
  708.  
  709.  
  710.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                  163
  712.  
  713.           f:
  714.           browse c:/src
  715.       displays each file in the src directory beginning with the newest.
  716.       Typing c tells ZCOMM you want to copy the file.  When ZCOMM asks for
  717.       the filename, just hit <CR> and the file is copied.  (The resulting
  718.       command to command.com is "COPY c:/src/file").  This sequence may be
  719.       used to "clean up" a directory.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.       (C) 1993 Omen Tech Inc                       Chapter 19 Browse Command
  767.  
  768.  
  769.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                  164
  771.  
  772.       19.3  DOS Gateway
  773.  
  774.       A "Shell Escape" or "DOS Gateway" executes a DOS COMMAND (a program or
  775.       command) as a subroutine.  If the first non white-space character of
  776.       the line is !, the entire line, less the !, is executed as a DOS
  777.       command, as if it were typed to DOS in the absence of ZCOMM.  If the !
  778.       command is not the first command on the line, the command string must
  779.       conform to ZCOMM's rules pertaining to strings.  DOS Gateways are not
  780.       allowed if ZCOMM is RESTRICTED.
  781.  
  782.       If the next character is % the rest of the command is processed for
  783.       string substitutions.
  784.  
  785.  
  786.       EXAMPLE: !whereis thebeef.* Uses the public domain WHEREIS.COM program
  787.       to find certain files on the hard disk.
  788.  
  789.  
  790.       EXAMPLE: !dir >foo Generate a directory listing, with output
  791.       redirected by DOS to foo.
  792.  
  793.       The command line keys !dir keys displays the soft keys, executes a DOS
  794.       "dir" command without arguments, and then displays the soft keys
  795.       again, while the command line !dir keys calls DOS to print directory
  796.       information for the file keys.
  797.  
  798.       Before executing a !  command, ZCOMM restores the modem port's
  799.       Interrupt Service Routine's previous interrupt vector and interrupt
  800.       enable bits.  ZCOMM also synchronizes the BIOS display driver.  After
  801.       return from the DOS command, ZCOMM enables DTR, the ISR vector,
  802.       interrupts on the modem port, and resumes direct control of the
  803.       display.
  804.  
  805.       If the command name begins with "%" (per cent sign) the remainder of
  806.       the command string is processed for string substitution (but not
  807.       character escapes).
  808.  
  809.       EXAMPLE:      set s0 this.txt
  810.            !%mv %s0 bakdir
  811.  
  812.       If the command name (after an optional leading "%") begins with ~
  813.       (tilde), ZCOMM does NOT restore the modem port's Interrupt Service
  814.       Routine's previous interrupt vector and interrupt enable bits.  The
  815.       called program may then access the modem with the ROM BIOS interrupt
  816.       hex 14, which is mapped to ZCOMM's modem service routines during the
  817.       execution of the !~ command.
  818.  
  819.       When the modem is accessed this way, incoming characters are buffered
  820.       in ZCOMM's interrupt buffer, preventing loss of characters when
  821.       scrolling above 300 bits per second.  Unlike the ROM BIOS routines
  822.       (which are a compromise to allow driving serial printers), the ZCOMM
  823.  
  824.  
  825.       (C) 1993 Omen Tech Inc                          Chapter 19 DOS Gateway
  826.  
  827.  
  828.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                  165
  830.  
  831.       int 14h handler does not depend on the state of DSR or CTS.
  832.  
  833.       This interface allows other programs to perform specialized functions,
  834.       such as graphic screen operation or special CRT terminal emulation.
  835.       One such program is COMSH.EXE available on Compuserve's Programmers'
  836.       Special Interest Group (GO PCS-158).[26]
  837.  
  838.       EXAMPLE: !~comsh
  839.  
  840.       The ZCOMM BIOS EMULATOR replacing the int 14h modem service routine
  841.       accepts the standard BIOS INT 14h functions encoded in the AH register
  842.       as described in the IBM Technical Reference Manual.  Since the modem
  843.       port is selected by ZCOMM, the DX register is ignored.  The character
  844.       ready status bit reflects whether ZCOMM's modem interrupt buffer has
  845.       one or more characters waiting.
  846.  
  847.       The !~ command uses special logic to allow programs to exit gracefully
  848.       when carrier detect is lost.
  849.  
  850.       If the command contains a space but none of the ^ < > or | characters,
  851.       DOS ZCOMM attempts to execute the command with the Microsoft C
  852.       spawnvp() function, which returns the program's exit status to the ?
  853.       test condition.  Otherwise, or if the Microsoft C spawnvp() failed, !
  854.       commands are interpreted by DOS's COMMAND.COM; This kluge will go away
  855.       when Microsoft's rokcet scientests learn how to write a command.com
  856.       that executes commands and properly returns the exit status.
  857.  
  858.       Batch files and built-in commands may be invoked as well as programs.
  859.       Some useful DOS built-in commands are rename, copy, date, and time.
  860.  
  861.       Caution should be exercised with commands that affect disk files if
  862.       ZCOMM has files open at the time.  Programs that remain resident in
  863.       low memory (such as spoolers) should NOT be invoked from ZCOMM unless
  864.       they are already resident, as memory would become fragmented.
  865.       Invoking the DOS "print" command (if print isn't already resident) has
  866.       caused DOS to crash when ZCOMM exits.
  867.  
  868.       Memory available for !command will be less than when the command is
  869.       given directly to DOS without ZCOMM running.  The command "!chkdsk"
  870.       will display the amount of memory available for subprograms.
  871.  
  872.       NOTE: Some commands under some conditions may cause DOS to crash
  873.       immediately, after more commands are given, or when the user attempts
  874.       to return to DOS,  especially if insufficient memory is available.
  875.  
  876.  
  877.       __________
  878.  
  879.       26. COMSH supports graphic images transmitted by Compuserve's Weather
  880.           Radar service.
  881.  
  882.  
  883.  
  884.       (C) 1993 Omen Tech Inc                          Chapter 19 DOS Gateway
  885.  
  886.  
  887.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                  166
  889.  
  890.       The EXEC functions of nonstandard operating systems are notorious
  891.       sources of interesting debugging experiences.
  892.  
  893.  
  894.       If DOS fails to execute COMMAND.COM, (actually, the program specified
  895.       in COMSPEC), the message Shell Escape DOS error return = N is
  896.       displayed.  The usual DOS error returns are 1002,1005,1008,1010, and
  897.       1011, which are the DOS error return values + 1000:
  898.  
  899.       2  File not found (COMMAND.COM)
  900.  
  901.       5  Access Denied
  902.  
  903.       8  Insufficient memory
  904.  
  905.       10 Invalid environment
  906.  
  907.       11 Invalid format
  908.       Return values less than 1000 are returned by the application but are
  909.       lost by current versions of COMMAND.COM.  The return value is saved in
  910.       the ?  numeric parameter and may be tested with the ?  test condition.
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.       (C) 1993 Omen Tech Inc       Chapter 19 Protocol File Transfer OPTIONS
  944.  
  945.  
  946.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                  167
  948.  
  949.       20.  Protocol File Transfer OPTIONS
  950.  
  951.       Options modify the way the protocol file transfer commands send and
  952.       receive files.  They are reset before each command line.
  953.  
  954.       The a, b, r and rr options are mutually exclusive.  With ZMODEM, a b
  955.       option given to the sender or receiver will override any a option.
  956.  
  957.       The +, c, r, rr, N, n, p, and y options are mutually exclusive.  The Y
  958.       option may be followed by the c, +, r, n, or N option.  Specifying
  959.       these options to the receiver overrides the ZMODEM sender's
  960.       specification of these options.
  961.  
  962.       The DOS append command interferes with some of these options.
  963.  
  964.  
  965.       +  When receiving to a file already on disk, append the new data to
  966.          the file.  If the specified file does not exist, it is created.
  967.          This option is not allowed if ZCOMM is Restricted.
  968.  
  969.          EXAMPLE: rc -+ evrybody.dat
  970.  
  971.  
  972.          When sending files with ZMODEM, the + option commands the receiver
  973.          to append to a file already on the receiver's disk.
  974.  
  975.          EXAMPLE: sz -+ ONAME=master.log *.log sends all .log files in the
  976.          current directory to be appended to master.log on the receiver's
  977.          computer.
  978.  
  979.          NOTE: Append (+) is not the same as crash recovery (-r).  Append is
  980.          used to concatenate (add) new data to an existing file.  The
  981.          resulting file contains both old and new data.
  982.          NOTE: If an append (+) file transfer is interrupted and restarted,
  983.          data may be duplicated.
  984.  
  985.          SEE ALSO: r option
  986.  
  987.       7  Strip data to 7 bits for file transfers with the Kermit protocol.
  988.          Program executables and other 8 bit binary files cannot be sent
  989.          this way.  In the absence of the 7 option ZCOMM transfers all 8
  990.          bits of each byte.  If the communications line is set to 8 bits no
  991.          parity, the 8th bit is transmitted, otherwise ZCOMM requests 8th
  992.          bit quoting.  NOTE: The 7 option is distinct from the 7e and 7o
  993.          term options.
  994.  
  995.       a  (ASCII) The a option applies to files received with XMODEM, YMODEM,
  996.          or ZMODEM protocol.  It converts newlines not preceded by CR to
  997.          CR/LF pairs.  NULL, RUBOUT, and all characters in each packet
  998.          beginning with Ctrl-Z are excluded.  The a option is useful when
  999.          receiving text files without carriage returns directly from Unix
  1000.  
  1001.  
  1002.       (C) 1993 Omen Tech Inc       Chapter 20 Protocol File Transfer OPTIONS
  1003.  
  1004.  
  1005.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                  168
  1007.  
  1008.          systems.
  1009.  
  1010.          When sending with ZMODEM, the a option instructs the receiver to
  1011.          convert text files to the conventions used in its operating
  1012.          environment.  When sending to VAX/VMS rz this selects CR carriage
  1013.          control variable length record format.
  1014.  
  1015.          The a option does not apply to the Kermit, sx, or sb commands.
  1016.          Files transferred with the a option cannot be processed with the
  1017.          ZMODEM r (recover/resume) option.
  1018.  
  1019.          EXAMPLE: rc -a program.c receives program.c and converts end of
  1020.          lines to CR/LF.
  1021.  
  1022.  
  1023.       b  (Binary) With ZMODEM, inhibits the receiver from translating the
  1024.          file contents.  If either the ZMODEM sender or receiver specifies b
  1025.          option, any contrary requests will be ignored.
  1026.  
  1027.          EXAMPLE: sz -b program.exe
  1028.  
  1029.  
  1030.       c  With ZMODEM, change the file name to prevent collision if the
  1031.          destination file exists.  The receiving program must support the
  1032.          ZMODEM c option or file disposition will be undefined.  The form of
  1033.          the invented (changed) filename is implementation dependent.
  1034.  
  1035.          Use CRC-16 with the rx, rt, and r7 commands.
  1036.  
  1037.       e  Normally, ZMODEM senders escape XON, XOFF, Ctrl-P, CR-@-CR, and
  1038.          Ctrl-X, and ZMODEM receivers ignore XON and XOFF.  The e option
  1039.          escape all control characters when sending files with the ZMODEM
  1040.          protocol.  In 7-bit environments, the e option also escapes RUBOUT
  1041.          (7F).[1] This option is useful when operating with brain damaged
  1042.          data PBX systems and other types of "front ends".
  1043.  
  1044.          SEE ALSO: zmtxesc, zmrxesc string parameters
  1045.  
  1046.       E  With ZMODEM-90, force 8th bit encoding even if the transmission
  1047.          medium appears to support 8 bits.[2]
  1048.  
  1049.       f  Send the full pathname as specified (exclusive of disk identifier)
  1050.          when using a batch send command.  Normally only the file name
  1051.  
  1052.  
  1053.       __________
  1054.  
  1055.        1. In 7-bit environments, ZMODEM always escapes FF.
  1056.  
  1057.        2. Not featured in DSZ.COM.
  1058.  
  1059.  
  1060.  
  1061.       (C) 1993 Omen Tech Inc       Chapter 20 Protocol File Transfer OPTIONS
  1062.  
  1063.  
  1064.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                  169
  1066.  
  1067.          portion (without any directory prefix) is transmitted.  The f
  1068.          option applies to batch file transmission with the kermit sb, sb,
  1069.          send, and sz commands.
  1070.  
  1071.          EXAMPLE: cd /src; sz -f robot/r2d2.h sends the file with the
  1072.          pathname robot/r2d2.h.
  1073.  
  1074.  
  1075.          EXAMPLE: sz -f /src/robot/vox/3tpi0.*
  1076.  
  1077.  
  1078.          SEE ALSO: PREFIX=p flag for the sb and sz commands.
  1079.  
  1080.       F  Insert a pause after each transmitted data subpacket transmitted
  1081.          with ZMODEM.  This is useful in certain situations when
  1082.          conventional flow control methods are unavailable, ineffective, or
  1083.          unreasonably slow (i.e., "broken").  The length of pause is set by
  1084.          the zmodem F numeric parameter.
  1085.  
  1086.          EXAMPLE: sz -F honker.dat
  1087.  
  1088.  
  1089.          SEE ALSO: zmodem F numeric parameter
  1090.  
  1091.       g  Given to the receiving program, the g option to the rb command
  1092.          allows the sender and receiver to dispense with acknowledging each
  1093.          transmitted packet when using YMODEM batch transfers.  YMODEM-g
  1094.          increases throughput when the transmitting medium itself (direct
  1095.          connection, X.PC session, or error correcting modems) provides
  1096.          error free transmission.  The transmitting medium can use XOFF and
  1097.          XON to enforce flow control.
  1098.  
  1099.          If the transmitting medium does not enforce flow control,[3] the
  1100.          user must insure the receiver is not overrun.  ZCOMM on a PC or XT
  1101.          accepts data at 9600 bps without flow control when the file is
  1102.          being written to a hard disk or ramdisk.[4]
  1103.  
  1104.          If an error is detected when the g option is used, the transfer is
  1105.          aborted.
  1106.  
  1107.          EXAMPLE: rb -g
  1108.  
  1109.  
  1110.  
  1111.       __________
  1112.  
  1113.        3. X.PC automatically enforces end to end flow control.
  1114.  
  1115.        4. Provided no memory resident programs or special drivers hog CPU
  1116.           cycles.
  1117.  
  1118.  
  1119.  
  1120.       (C) 1993 Omen Tech Inc       Chapter 20 Protocol File Transfer OPTIONS
  1121.  
  1122.  
  1123.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                  170
  1125.  
  1126.          The g option may also be used with the rx command to receive files
  1127.          from Qmodem's G protocol.
  1128.  
  1129.       i  With YMODEM or ZMODEM, instructs the receiver to write file(s) in
  1130.          stream oriented Image format.  When sending to the VAX/VMS version
  1131.          of rz, the i option selects Stream_LF record format.  Stream_LF
  1132.          preserves the exact contents of binary files read by VMS C
  1133.          programs.  Stream_LF is useful for file servers and archives that
  1134.          service PCs, as well as C programs on VMS itself.  (Without the i
  1135.          option, the VMS rz default is 512 byte fixed length record format.)
  1136.  
  1137.       I  With YMODEM or ZMODEM, instructs the receiver to write file(s) in
  1138.          variable length binary record Image format.  When sending to the
  1139.          VAX/VMS version of rz, the i option selects Variable length
  1140.          (mrs=510) binary record format.  Certain programs such as Kermit32
  1141.          understand this binary record format better than Stream_LF.
  1142.  
  1143.       k  Use 1024 byte (1K) packets with the sb and sx commands.  The
  1144.          default packet length is 128.  This increases throughput when the
  1145.          speed is high relative to the response times of the communications
  1146.          channel and the computers.  The k option is useful with 9600 or
  1147.          19200 bps transfers with directly connected timesharing systems.
  1148.          The k option may not work properly uploading to some systems,
  1149.          particularly heavily loaded or poorly implemented timesharing
  1150.          systems at high speeds.  The k option is valid only when sending to
  1151.          ZCOMM, Unix rb, or other compatible programs.  If the file length
  1152.          is not a multiple of 1024, the remainder of the file will be sent
  1153.          with 128 byte blocks.  This option does not affect Kermit
  1154.          transfers.
  1155.  
  1156.          EXAMPLE: sb -k *.c *.h
  1157.  
  1158.          With the sz command, the k option forces an initial 1024 byte
  1159.          subpacket length.
  1160.  
  1161.          EXAMPLE: sz -k *.c *.h
  1162.  
  1163.  
  1164.       l  Force pathnames that are all uppercase to lower case.  This option
  1165.          is reset by the call command.  This option is ignored on DOS and
  1166.          OS/2 flavors of ZCOMM.
  1167.  
  1168.       m  (ZMODEM-90) Activate MobyTurbo(TM) for maximum throughput on
  1169.          compressed files sent over completely transparent connections.
  1170.          MobyTurbo can be used over links that support YMODEM-g.  Moby Turbo
  1171.          can not be used with most forms of software flow control or over
  1172.          networks that reserve control characters.
  1173.  
  1174.       M  Locks out Moby Turbo even if the other program has given the m
  1175.          option.  This option is useful if the transmission path does not
  1176.          support complete transparency.
  1177.  
  1178.  
  1179.       (C) 1993 Omen Tech Inc       Chapter 20 Protocol File Transfer OPTIONS
  1180.  
  1181.  
  1182.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                  171
  1184.  
  1185.       n  (ZMODEM) Each file is transferred if the corresponding destination
  1186.          file does not exist, or if the source file is newer.  The n option
  1187.          can be given with either the sz or rz commands.  This option is not
  1188.          allowed if the receiver is Restricted.
  1189.  
  1190.          EXAMPLE: sz -n *.* attempts to send all files in the current
  1191.          directory.  Only those files that do not exist in the destination
  1192.          directory, and those for which the source is newer will be sent.
  1193.  
  1194.  
  1195.       N  (ZMODEM) Transfer the file if the corresponding destination file
  1196.          does not exist, or if the source file is newer or longer.  The N
  1197.          option be used with the sz and rz commands.  This option is not
  1198.          allowed if the receiver is Restricted.
  1199.  
  1200.          EXAMPLE: sz -N *.*
  1201.  
  1202.  
  1203.       p  (ZMODEM) Protect destination file; bypass this file if it already
  1204.          exists on the destination system.
  1205.  
  1206.       P  (ZMODEM-90) When transferring files over 7 bit paths, pack 4 8-bit
  1207.          bytes into 5 7-bit bytes for transmission instead of quoting the
  1208.          8th bit.[5] This increases transmission speed on compressed files.
  1209.  
  1210.       q  (Quiet) suppresses block by block status line update during Kermit
  1211.          and X/YMODEM file transfers.  Also prevents skipped files from
  1212.          incrementing the e numeric parameter and e test condition.
  1213.  
  1214.       r  (ZMODEM) Resume/Recover an interrupted file transfer with the
  1215.          ZMODEM protocol.  May be given with either the sz or rz commands.
  1216.  
  1217.          The r option may be used to resume the transmission of a long file
  1218.          after a disconnect or power loss, without having to start over at
  1219.          the beginning of the file.  The r option may also be used when the
  1220.          source file grows from time to time and only the incremental
  1221.          portion needs to be sent.  The r option assumes that the contents
  1222.          of the destination file are identical to the corresponding
  1223.          beginning portion of the source file.  The r option should not be
  1224.          applied to a file that has been modified by the a option.  This
  1225.          option is not allowed if the receiver is Restricted.
  1226.  
  1227.          EXAMPLE: sz -r hugefile.lst
  1228.  
  1229.  
  1230.  
  1231.  
  1232.       __________
  1233.  
  1234.        5. Not supported in DSZ.COM.
  1235.  
  1236.  
  1237.  
  1238.       (C) 1993 Omen Tech Inc       Chapter 20 Protocol File Transfer OPTIONS
  1239.  
  1240.  
  1241.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                  172
  1243.  
  1244.          SEE ALSO: zmodem c numeric parameter
  1245.  
  1246.          For convenience, the r option can be specified on all files if
  1247.          desired, even those that have not been interrupted during a
  1248.          transfer.  However, if you do make the r option the default with
  1249.          adlopts  you could inadvertently overwrite valuable data with
  1250.          unrelated data from a random file with the same file name.
  1251.  
  1252.          The "ZMODEM Crash Recovery at NNNN" message may not appear when
  1253.          performing Crash Recovery on very short files.
  1254.  
  1255.       rr As above, but the files are compared by taking a 32 bit CRC on the
  1256.          contents before deciding on whether to start a fresh transfer.
  1257.  
  1258.          EXAMPLE: sz -rr maybenewer.lst
  1259.  
  1260.  
  1261.          With the -rr option, all of the files are compared or transmitted
  1262.          by default.  The number of bytes used in the comparison may be
  1263.          restricted by setting the zmodem R numeric parameter to a number
  1264.          between 2048 and 32000 (1 billion on 32 bit flavors).
  1265.  
  1266.          EXAMPLE: zmodem pR20000
  1267.  
  1268.  
  1269.       R  Recursively descend directories specified in wild cards when
  1270.          expanding file names.
  1271.  
  1272.          EXAMPLE: sz -Rf src
  1273.          Sends the files in the src directory and its subdirectories (R
  1274.          option), and transmits the full relative pathname (f option).
  1275.  
  1276.  
  1277.          SEE ALSO: f option
  1278.  
  1279.       s  SlugBait modifies the logic of ZMODEM sending to detect and report
  1280.          attempts at evading accountability for receiving files.  Such
  1281.          attempts are flagged with a Q status in the log of sent files.
  1282.          SlugBait adds a slight delay to file transmission, and a transfer
  1283.          that is cut off at the very end of file may very infrequently be
  1284.          reported with Questionable instead of ERROR status.
  1285.  
  1286.       S  When sending file(s) with ZMODEM, interrogate the receiving program
  1287.          for its serial number.  S option terminates when a serial number is
  1288.          received or when the call command is given.  Receiving file(s) with
  1289.          YMODEM or ZMODEM from programs providing a serial number also
  1290.          provides the other program's serial number.  The serial number
  1291.          received is listed by the performance log.
  1292.  
  1293.       t  Enter the term function after file transfer(s) complete.  The t
  1294.          option should not be used in commands given from within the term
  1295.  
  1296.  
  1297.       (C) 1993 Omen Tech Inc       Chapter 20 Protocol File Transfer OPTIONS
  1298.  
  1299.  
  1300.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                  173
  1302.  
  1303.          function, either directly or with soft key definitions.
  1304.  
  1305.       u  Unlink (remove, delete) the file after it has been sent with the sz
  1306.          command.
  1307.  
  1308.       v  View the data being transmitted or received.  Only correct data is
  1309.          displayed.  Viewing standard ASCII files does not interfere with
  1310.          correct transmission at high speeds, although throughput may be
  1311.          degraded.
  1312.  
  1313.          The output may be redirected to a capture file or DOS device with
  1314.          the > or >> command.  Unless output is redirected, this option must
  1315.          not be used when ZCOMM is in Host Operation.
  1316.  
  1317.          When invoking Unix ZCOMM as xyam, rz, sz, rb, sb, rx, or sx,
  1318.          creates a logging file with information useful for debugging
  1319.          purposes.  More v's create more detailed debugging information.
  1320.  
  1321.          SEE ALSO: v numeric parameter, LOGFILE environment variable
  1322.  
  1323.       wN Use a window size of N bytes with the sz command, overriding the
  1324.          zmodem w numeric parameter.  If N is missing, use a ZMODEM window
  1325.          size of 4096 bytes.
  1326.  
  1327.          SEE ALSO: Flow Control Chapter 14, zmodem w numeric parameter
  1328.  
  1329.       WN Request the sending program to use a window size of N bytes,
  1330.          overriding the sender's window size setting, 4096 bytes if N is
  1331.          missing.[6]
  1332.  
  1333.       y  Yes it is OK to replace a file already on disk when receiving a
  1334.          file.  If absent, the operator is given a choice of appending to
  1335.          the current file (a), erasing it (y) or aborting (n).  This option
  1336.          is not allowed if ZCOMM is Restricted.  When sending with ZMODEM,
  1337.          commands the receiver to replace a file on its disk.
  1338.  
  1339.       Y  (ZMODEM) Transfer only those files for which a file with the same
  1340.          pathname exists at the destination, overwriting the destination
  1341.          files.  The Y option may be followed by other ZMODEM options to
  1342.          further qualify the selection of files to transfer.  This option is
  1343.          not allowed if ZCOMM is Restricted.
  1344.  
  1345.          EXAMPLE: sz -Yn *.* If the source directory contains files A, B,
  1346.          and C, each dated today, and the destination directory contains B
  1347.  
  1348.  
  1349.       __________
  1350.  
  1351.        6. The W option is supported when receiving files from ZMODEM-90(TM)
  1352.           program versions after Jan 21 1990.
  1353.  
  1354.  
  1355.  
  1356.       (C) 1993 Omen Tech Inc       Chapter 20 Protocol File Transfer OPTIONS
  1357.  
  1358.  
  1359.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                  174
  1361.  
  1362.          and C, with B a week old and C dated today, only B will be sent.
  1363.  
  1364.  
  1365.       zT Use T minutes behind GMT (Greenwich Mean Time) as the local
  1366.          timezone instead of the z parameter value for the file(s)
  1367.          transferred with this command.
  1368.  
  1369.          EXAMPLE: sb -k -z300 ESTfile sends ESTfile corrected for creation
  1370.          in Eastern Standard Time.
  1371.  
  1372.  
  1373.       Z  Transmit files with compression.  The ZMODEM receiver must indicate
  1374.          its ability to decompress received files for this option to take
  1375.          effect.
  1376.  
  1377.          When sending between Unix systems, files are compressed with 12 bit
  1378.          Lempel-Ziv compression.  Otherwise, packets are transmitted with
  1379.          Run Length Encoding.
  1380.  
  1381.          Over slow channels, compression increases the transmission speed of
  1382.          compiler listings, screen dumps, etc. by up to 50 per cent.  LZW
  1383.          compression is more effective on more types of data than RLE
  1384.          compression.  Some files, including the Personal Computing Magazine
  1385.          ASCII Test File, speed up by more than an order of magnitude with
  1386.          either RLE or LZW compression.  Heavily encrypted data and
  1387.          compressed files, including ARC and ZOO archives, do not benefit
  1388.          from ZMODEM compression.
  1389.  
  1390.          The situation with fast compressed modems is more complex.  The
  1391.          benefits of ZMODEM compression will depend on the particular
  1392.          application; try the transfers with and without ZMODEM compression
  1393.          to determine the most efficient options.
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.       (C) 1993 Omen Tech Inc                        Chapter 20 Term Function
  1416.  
  1417.  
  1418.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                  175
  1420.  
  1421.       21.  TERM FUNCTION
  1422.  
  1423.       Interactive conversation with the remote is controlled by the term
  1424.       function.  The term function provides the conversational link between
  1425.       the keyboard, display, printer, and the remote computer.  ZCOMM's term
  1426.       function also controls the capture of data from the remote, "non-
  1427.       protocol" sending of files and commands, and recognition of the
  1428.       remote's responses (pattern searches).
  1429.  
  1430.       The term function is entered by the F2, f, put, putw, t and wait
  1431.       commands, and by the rx and sx commands when the t term option is
  1432.       used.
  1433.  
  1434.       The term function receives characters from the remote computer.  If 8g
  1435.       option is not used, the parity bit is stripped.  Received characters
  1436.       are displayed on the screen, printed, searched, or trigger Kermit and
  1437.       ZMODEM AutoDownloads(TM).
  1438.  
  1439.       Normally, the term function acts upon keyboarded characters
  1440.       immediately.  If the term function is sending a string with the put or
  1441.       putw commands, or if the keyboard has been locked with the kbdlock
  1442.       command, keystrokes are not drained from the keyboard buffer.  If ANSI
  1443.       KAM (Keyboard Action Mode) escape sequence has been received,
  1444.       keystrokes are discarded with a bleep of the bell.
  1445.  
  1446.       Normal ASCII printing and control characters are sent to the remote.
  1447.       Some keys may be redefined with the set command.  NUKE (ALT-N) returns
  1448.       control to the main command prompt.  The term function returns to its
  1449.       caller when an F1 or ALT-X key is struck.
  1450.  
  1451.       A carrier detect loss during a pattern search or a satisfied search[1]
  1452.       cause the term function to return.  Counting the error count (e
  1453.       numeric parameter) UP TO 0 makes the term function return.  An ETX or
  1454.       EOT received from the remote when q term option is on also does the
  1455.       trick.  Finally, an EOF on a file uploaded with x term option, or a
  1456.       match on a file uploaded with X term option makes the term function
  1457.       return.
  1458.  
  1459.       21.1  Major Modes of Operation
  1460.  
  1461.       The term function can operate in several Major Modes affecting
  1462.       keyboarded characters.[2]
  1463.  
  1464.  
  1465.  
  1466.       __________
  1467.  
  1468.        1. Unless the c modifier was used
  1469.  
  1470.        2. Not all Major Modes are supported on all operating systems.
  1471.  
  1472.  
  1473.  
  1474.       (C) 1993 Omen Tech Inc                        Chapter 21 Term Function
  1475.  
  1476.  
  1477.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                  176
  1479.  
  1480.       Terminal Emulation Normal mode operates according to the terminal
  1481.            emulation selected.  Keyboard mapping with set and mk commands is
  1482.            effective.
  1483.  
  1484.       Conference The conference command (described at the end of this
  1485.            chapter) provides local editing of keyboarded characters before
  1486.            transmission.
  1487.  
  1488.       Chat The chat command links two keyboards interactively.
  1489.  
  1490.       21.2  Major Sub-Modes
  1491.  
  1492.       Doorway Doorway is activated with the ALT-= key to allow function and
  1493.            alt keys to be passed to certain BBS systems.
  1494.  
  1495.       Scancode Scancode passes raw scancodes to VP/ix and similar
  1496.            applications.
  1497.  
  1498.  
  1499.       21.3  Command Characters
  1500.  
  1501.       In the term function, soft key definitions override the keys' normal
  1502.       functions.
  1503.  
  1504.       ALT-= Toggles the term function keyboard handling between normal,
  1505.         doorway, and scancode operation.
  1506.  
  1507.         In doorway operation, ALT, cursor, and function keys are transmitted
  1508.         as NULL followed by the raw scan code.  This is especially useful
  1509.         when operating the PC Board ProDoor full screen editor.
  1510.  
  1511.         In scancode operation, raw scan codes are transmitted for use by
  1512.         VP/ix and other programs that require raw IBM keyboard scan codes.
  1513.  
  1514.         Both doorway or scancode operation override all term function key
  1515.         bindings escept for ALT-= which toggles between these forms of
  1516.         operation.
  1517.  
  1518.       Backspace Normally the term function sends backspace to the remote
  1519.         without any special processing.  This is ideal for most systems
  1520.         where backspace implies deletion of the character immediately to the
  1521.         left of the cursor.  Other systems, including VMS, use RUBOUT for
  1522.         this function.  The GCOS system uses the # character for this
  1523.         function.  The special requirements of these systems can be
  1524.         optimally accomodated by assigning a string or series of commands to
  1525.         the BS key.  Chapter 99 provides some examples.
  1526.  
  1527.       F1, ALT-X Return from the term function.  ALT-X is an alternate to F1
  1528.         in case the user has assigned his own string or command to F1.
  1529.  
  1530.  
  1531.  
  1532.  
  1533.       (C) 1993 Omen Tech Inc                        Chapter 21 Term Function
  1534.  
  1535.  
  1536.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                  177
  1538.  
  1539.       F2, PgUp, PgDn, ALT-R Enter the review function displaying data
  1540.         starting with either the first character received after the last
  1541.         character keyboarded (except space, Ctrl-Q, or Ctrl-S), or about 48
  1542.         lines back if less than 400 characters have been received since the
  1543.         last character keyboarded.  This allows the output from the last
  1544.         command to be conveniently reviewed.  Review then awaits the next
  1545.         command.
  1546.  
  1547.         F2 followed by "k" is a handy way to clear both the screen and the
  1548.         circular buffer.
  1549.  
  1550.       Up Enter remote command recall and select the previous remote command
  1551.         for editing in the status line.  Backspace, and Ctrl-W may be used
  1552.         for editing the line.  Ctrl-U and Ctrl-X clear the line's contents
  1553.         and restore normal term function operation.
  1554.  
  1555.       Down Enter remote command recall and select the next remote command
  1556.         for editing in the status line.
  1557.  
  1558.       Home Enter review function, displaying text starting at the beginning
  1559.         of the buffer.  ALT-R is an alternate to F2 in case the user has
  1560.         assigned his own string or command to F2.
  1561.  
  1562.       F3...F10, FS1...FS4 Chapter 19 describes the functions that the
  1563.         "setup" entry in the sample PHODIR.t file assigns to these keys.
  1564.  
  1565.       Ctrl-Break Sends a 200 millisecond (default) break signal to the
  1566.         remote.  The function of this key may be reassigned with a set
  1567.         command.
  1568.         NOTE: Some modems do not correctly pass a break signal to the
  1569.         remote.
  1570.  
  1571.       Ctrl-Shift-2 Some remote computer systems may require sending the NULL
  1572.         (000) character.  NULL may be keyboarded by Ctrl-Shift-2.
  1573.  
  1574.       ^F Iff q (TWX) term option is in effect, transmit the string parameter
  1575.         answerback to the remote.  This is equivalent to HEREIS on a
  1576.         Teletype(TM) machine.
  1577.  
  1578.       Enter Iff n term option is set, send a newline (LF).  Otherwise, send
  1579.         the contents of entstr (default CR) to the remote.
  1580.  
  1581.       ^Q Iff a transmit file is open and its transmission has been stopped
  1582.         by a XOFF, transmission is resumed.  Resumes counting of the
  1583.         inactivity timeout associated with the wait and pattern commands.
  1584.         Otherwise no special treatment.
  1585.  
  1586.       Rubout The ASCII delete (rubout) character (hex 7F, octal 177) is
  1587.         generated by Ctrl-Backspace (the left arrow above the ENTER key on
  1588.         the PC keyboard).  The "Del" key near the lower right of the
  1589.         keyboard does not generate delete, but may be programmed to do so
  1590.  
  1591.  
  1592.       (C) 1993 Omen Tech Inc                        Chapter 21 Term Function
  1593.  
  1594.  
  1595.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                  178
  1597.  
  1598.         with a "set fdel \177" command.
  1599.  
  1600.       ^S Iff a transmit file is open, transmission is stopped.  Otherwise ^S
  1601.         is transmitted.  ^S also suspends counting of the inactivity timeout
  1602.         associated with the wait and pattern commands.
  1603.  
  1604.       ALT-B Sends a 100 millisecond break signal to the remote.
  1605.         NOTE: Some modems do not correctly pass the break signal to the
  1606.         remote.
  1607.  
  1608.       ALT-N The NUKE key exits from the term function with a message and
  1609.         cancels any scripts or functions that may have been executing.
  1610.  
  1611.       ALT-1 Prompts for a DOS command, then executes that command as a
  1612.         subroutine.
  1613.  
  1614.         EXAMPLE: ALT-1 whereis *.lst
  1615.  
  1616.  
  1617.       ALT-2 Prompts for a ZCOMM command, then executes that command.  A
  1618.         particularly useful command is "create file" which creates a capture
  1619.         file without having to return to the main command prompt.  Care
  1620.         should be exercised not to force excessive recursion by issuing a
  1621.         command (such as t or f) which would invoke the term function
  1622.         recursively.
  1623.  
  1624.         EXAMPLE: ALT-2 create capture.fil
  1625.  
  1626.  
  1627.         EXAMPLE: ALT-2 display vt100
  1628.  
  1629.  
  1630.       ALT-E Resets the elapsed time indication to zero.
  1631.  
  1632.       ALT-F Full Duplex resets local echo of keyboarded characters.
  1633.  
  1634.       ALT-H Toggles Half duplex in the sequence 0 (full duplex), 1 (local
  1635.         echo), and 2 (local echo CR as CR LF).  SEE ALSO: h numeric
  1636.         parameter
  1637.  
  1638.       ALT-I Three way toggle of i and I (Image) term option.  When toggling
  1639.         to I (super image) term option, ZCOMM's display emulation is set to
  1640.         dumb to disable all escape sequences, most importantly those that do
  1641.         strange things when used in the wrong context.  When toggling out of
  1642.         I term option, dumb terminal emulation is turned off.
  1643.  
  1644.       ALT-J Toggles j (Jabberwrite) term option (q.v.).*
  1645.  
  1646.       ALT-K Displays the contents of the soft keys.
  1647.  
  1648.  
  1649.  
  1650.  
  1651.       (C) 1993 Omen Tech Inc                        Chapter 21 Term Function
  1652.  
  1653.  
  1654.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                  179
  1656.  
  1657.       ALT-L Ctrl-PrtSc Toggles the line printer on flag.  If the printer is
  1658.         being turned on, printing commences with the next character received
  1659.         from the remote.
  1660.  
  1661.       ALT-M Toggles keyboard mapping.
  1662.  
  1663.         SEE ALSO: display mapkb command
  1664.  
  1665.       ALT-O Toggles Overstrike display, and restores the normal CRT
  1666.         attribute.
  1667.  
  1668.       ALT-P Toggles the parity the term function uses between 8 bits no
  1669.         parity, 8 bits graphics, 7 bits plus even parity, 7 bits plus odd
  1670.         parity, 7 bits marking parity (8th bit set), and 7 bits spacing
  1671.         parity (8 bit reset).
  1672.  
  1673.       ALT-V Four way toggles v term option between normal, show control
  1674.         characters as ^C, denote characters with parity bit (in addition to
  1675.         the above) set by prepending a tilde (~), and display all characters
  1676.         in hex.*
  1677.  
  1678.       21.4  Control Characters
  1679.  
  1680.       The following characters are recognized by the term function when they
  1681.       are received from the remote.
  1682.  
  1683.       ENQ, DLE If c or C (Compuserve) term option and v term option is not
  1684.         in effect, engage the Compuserve B+ Protocol.  This protocol is used
  1685.         with the FILTRN program and the SIG/ACCESS DOW and UPL commands.
  1686.         See Compuserve's CP-MIG user group documentation for more
  1687.         information.  Iff enabled, these codes are acted upon when drained
  1688.         from the interrupt input buffer and are not passed to the circular
  1689.         buffer.
  1690.  
  1691.       The following received characters are recognized by the term function,
  1692.       regardless of parity, when they are fetched from the circular buffer
  1693.       for the display.
  1694.  
  1695.       Modem Error Detected modem errors (parity error, framing error, break,
  1696.         overrun) are counted in the e numeric parameter.  The E numeric
  1697.         parameter may be used to represent modem errors as specific,
  1698.         searchable characters.
  1699.  
  1700.         A detected overrun is displayed as a large fuzzy rectangle (hex B2).
  1701.  
  1702.       ETX EOT Ctrl-Z When receiving a message with the TWX protocol (in Host
  1703.         Operation) these control characters will terminate the message.
  1704.  
  1705.       ENQ Iff q (TWX) term option or VT100 emulation ("display vt") is in
  1706.         effect, transmit the answerback string parameter to the remote.
  1707.         This is equivalent to HEREIS on a Teletype(TM) machine.
  1708.  
  1709.  
  1710.       (C) 1993 Omen Tech Inc                        Chapter 21 Term Function
  1711.  
  1712.  
  1713.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                  180
  1715.  
  1716.       BELL Generates a tone in the speaker unless visual bell display is
  1717.         enabled ("display bell=visual").  If the display has fallen behind
  1718.         the incoming data, ZCOMM suppresses the bell due to the relatively
  1719.         long time required to perform a bell ring.  If a file is being
  1720.         transmitted with the term function, a bell character will pause
  1721.         transmission for a short time.  (Some computers send bell characters
  1722.         to indicate their input buffers are becoming overloaded.)
  1723.  
  1724.       FF If c term option is enabled, erase the screen.
  1725.  
  1726.       XOFF Suspends file transmission from ZCOMM.  XOFF is excluded from
  1727.         pattern searches and does not display unless v term option is set.
  1728.         After a timeout determined by the Kermit s numeric parameter
  1729.         (default 60 seconds), transmission will resume even if no XON
  1730.         character is received.[3]
  1731.  
  1732.       XON Resumes file transmission from ZCOMM.  XON is excluded from
  1733.         pattern searches and does not display unless v term option is set.
  1734.  
  1735.       NULL, Rubout (Hex 7F) and NULL (0) are not displayed unless ZCOMM is
  1736.         in i (image) or v term option.  They are excluded from pattern
  1737.         searches.
  1738.  
  1739.       21.5  Buffer Writing
  1740.  
  1741.       If e (Emacs) term option is set, a buffer dump is performed before
  1742.       each keyboarded character is sent to the remote, since normal XOFF
  1743.       based flow control is assumed to be disabled.
  1744.  
  1745.       When the free space in the circular buffer is nearly exhausted, ZCOMM
  1746.       sends an XOFF character to the remote[4] and writes the buffer
  1747.       contents to the receive file[5] (if any).  The circular buffer is also
  1748.       written to the receive file as a result of a "w" command, ALT-W key,
  1749.       or once per second if j term option is in effect.
  1750.  
  1751.       When the circular buffer is written to a receive file, several control
  1752.       characters are treated specially if i (image) term option is not set.
  1753.       Iff s term option is set, all control characters, except for those
  1754.       listed below, are excluded from the received file.
  1755.  
  1756.  
  1757.  
  1758.       __________
  1759.  
  1760.        3. There is no timeout if the parameter is 0.
  1761.  
  1762.        4. Assuming e term option is not in effect.
  1763.  
  1764.        5. An XON is sent to the remote after this automatic buffer write
  1765.           operation.
  1766.  
  1767.  
  1768.  
  1769.       (C) 1993 Omen Tech Inc                        Chapter 21 Term Function
  1770.  
  1771.